随机数流

RandStream 使用指定的伪随机数生成器算法创建随机数流。

您可以从一个或多个随机数流生成 MATLAB® 中的伪随机数。生成随机数数组的最简单方法是使用 rand、randi、randn 或 randperm 函数。这些函数全部依赖于同一个均匀分布的随机数流，称为全局流。更改全局流可以使用 RandStream，但这不是必需的。如果使用 RandStream 创建一个流，可以使用 RandStream.setGlobalStream 使其成为全局流。但是，rng 函数提供了更简单的接口来创建一个可以满足大多数用例需求的全局流。

您也可以使用 RandStream 创建流，然后使用 rand、randi、randn 或 randperm 从这些流中生成随机数。生成的随机数独立于从全局流或其他流中得到的随机数。有关详细信息，请参阅对象函数。

使用以下语法创建单个随机数流。如果要同时创建多个独立的流，请使用 RandStream.create 函数。

示例

s = RandStream(gentype) 创建一个随机数流，该数流使用 gentype 指定的均匀伪随机数生成器算法。

示例

s = RandStream(gentype,Name,Value) 还使用一个或多个可选的 Name,Value 对组参量来控制流的属性。

全部展开

随机数生成器算法，指定为字符向量或字符串标量（用于指定随机数生成器）。MATLAB 提供了几种生成器算法。下表概述了可用的生成器算法的名称和关键属性。一些生成器算法支持多个流和子流来创建相互独立的随机数集。有关详细信息，请参阅创建和控制随机数流。

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: s = RandStream('mt19937ar','Seed',15,'NormalTransform','Polar')

随机数种子，指定为由 'Seed' 和非负整数或 'shuffle' 组成的以逗号分隔的对组。种子指定算法生成随机数的起点。'shuffle' 根据当前时间创建种子。如果指定一个整数，它必须介于 0 到 232 − 1 之间。

如果在 MATLAB 启动时或在运行仿真之前创建流，请将生成器种子指定为初始化步骤。要重现一个流，请每次使用相同的种子。虽然使用多个种子会产生多个随机数序列，但无法保证不同序列在统计上是独立的。如果不同序列在统计上独立很重要，请指定 Substream 属性或使用 RandStream.create 来创建在统计上独立的流。

使用 randn 从随机数流生成正态分布随机数的变换算法，指定为由 'NormalTransform' 和算法名称 'Ziggurat'、'Polar' 或 'Inversion' 之一组成的以逗号分隔的对组。有关详细信息，请参阅创建和控制随机数流。

全部展开

随机数流 s 具有可控制其行为的属性。使用 p = s.Property 访问属性，并使用 s.Property = p 修改属性。要保存和还原流 s 的所有属性，您可以分别使用 A = get(s) 和 set(s,A)。此列表描述 RandStream 的属性。

此 属性 为只读。

流使用的随机数生成器算法。有关生成器及其属性的汇总，请参阅生成器算法表。

并非所有生成器算法都支持多个流。对于某些生成器，您可以创建在统计上独立的多个流和子流。

数据类型: char

此 属性 为只读。

用于创建流的随机数种子，以非负整数形式返回。

数据类型: uint32

此 属性 为只读。

创建了当前流的组中的流数目，以正整数形式返回。

数据类型: uint64

此 属性 为只读。

用于创建当前流的流组中的当前流索引，以正整数形式返回。

数据类型: uint64

生成器的当前内部状态，指定为整数向量。状态向量的大小取决于生成器算法。设置此属性时，赋给 s.State 的值必须是以前从 s.State 读取的值。使用 reset 将流恢复为其初始状态（如果以前从 State 属性读取了值）。通过 State 属性保存并还原生成器的内部状态可允许您重现随机数序列。

内部状态确定随机数流 s 产生的随机数序列。每次从单个流中生成随机数时，流中生成器的状态都会转换，以创建在统计上独立且在分布上相同的连续值。

注意

仅还原随机数流的状态或重置流，以从流中重现结果。

数据类型: uint32

流当前设置为的子流的索引。

对于某些生成器类型，您可以从一个随机流创建不同子流。从不同子流生成的值是相互独立的。有关支持子流的生成器，请参阅生成器算法表。

数据类型: double

使用 randn 生成正态分布伪随机值的转换算法。

数据类型: char

s 是否生成对偶伪随机值，指定为逻辑值 true (1) 或 false (0)。对偶值是从 1 中减去默认生成的均匀分布伪随机值。

数据类型: logical

s 是否使用其全精度生成值，指定为逻辑值 true (1) 或 false (0)。如果 FullPrecision 为 false，则某些生成器可以更快地创建伪随机值，但这些值的随机位数更少。

数据类型: logical

默认情况下，随机数生成函数（如 rand）使用全局随机数流。要指定不同流，请创建一个 RandStream 对象，并将其作为第一个输入参量进行传递。例如，使用面向 SIMD 的快速梅森旋转创建一个 4×1 随机数向量。

这些函数接受 RandStream 对象：

支持的语法，其中 s 是 RandStream 对象：

支持的语法，其中 s 是 RandStream 对象：

RandStream 的其他对象函数有：

全部折叠

使用面向 SIMD 的快速梅森旋转创建一个随机数流。

使用该流生成五个随机数。

基于当前时间使用生成器种子创建一个随机数流。通常不需要在每个 MATLAB® 会话中多次执行该操作，因为它可能会影响 MATLAB 生成的随机数的统计属性。

使用该流创建一个 3×3 随机值矩阵，其中的随机值在 0 和 1 之间均匀分布。

从该流创建另外五个随机数。

创建一个由单精度数组成的 2×3 矩阵。

创建种子为零的一个随机数流。

使用该流生成一个与 p 具有相同大小和数据类型的由随机数组成的数组。

创建种子为零的一个随机数流。

从该流生成五个随机数。每次您从该流生成一个数字时，生成器算法都会转换内部状态，以便下一个生成的数字与前一个数字独立同分布。

保存生成器的当前状态。生成另外五个随机数。

要重现五个随机数的最后结果，请将生成器状态还原到保存的状态。

只读取和写入生成器状态以从该流重现特定的结果。

创建一个种子为 3 的随机数流。使用该流生成八个随机数。

用等于 3 的种子将随机数流重置为其初始状态。重现生成的八个随机数。

重置流的种子会使其与其他流间的独立性失效。仅在需要从该流中重现结果时重置流。

创建两个随机数流。使用 RandStream.setGlobalStream 将第一个流设置为全局流。

要显示当前全局流，请使用 RandStream.getGlobalStream。

创建第二个流 myStream，它独立于您创建的新全局流。

从全局流中生成三个随机数。从您创建的局部流 myStream 中生成另外三个随机数。

当您在不使用 myStream 的情况下调用函数 rand、randn 和 randi 时，它们从全局流中提取数据，不会影响使用 myStream 时调用这些函数的结果。

对于某些生成器类型，您可以从一个随机流创建不同子流。从不同子流生成的值是相互独立的。

例如，使用组合的多重递归生成器创建一个随机数流。

要将一个流重新定位到特定子流，请设置其 Substream 属性。例如，在循环中生成随机数。在循环的每次迭代之前，将随机数流定位到一个不同子流的开头。生成 3 组相互独立的 5 个随机数。

要重现第二组的 5 个随机数，请将流重新定位到对应的子流。

全部展开

随机数流是由确定性算法生成的一个伪随机数序列的源。伪随机序列是随机数理论序列的逼近，其分布满足独立同分布 (i.i.d.) 条件，但实际上，确定性算法无法生成 i.i.d 序列。算法生成的序列可通过分布和相关性的统计检验，表明它们是很好的逼近。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

在 R2008b 中推出

rng | rand | randi | randn | randperm